home *** CD-ROM | disk | FTP | other *** search
/ Amiga News 95 / Amiga News 95.iso / dpat / dpat57 / adeline / adeline.doc < prev    next >
Text File  |  1994-02-28  |  10KB  |  355 lines
  1. ***********************************************************************
  2. ************** Adeline, votre secrétaire en version 1.1 ***************
  3. *************        (c) 1994 Thomas PIMMEL         **************
  4. ************                          *************
  5. *************  Assemblé le 28.2.94             **************
  6. **************                        ***************
  7. ***********************************************************************
  8.  
  9.  
  10.  
  11. 1> Introduction :
  12.  
  13.  Vu que j'ai une heure pour rédiger cette doc, ne traînons pas sinon
  14. je serai en retard et les autres commenceront à festoyer sans moi.
  15.  
  16.  ADELINE est un programme (si si) qui affiche des petites notes dans
  17. un écran public. Le type même d'écran public est votre WorkBench.
  18.  
  19.  Ces notes peuvent contenir jusqu'à 208 caractères. Elles s'affichent
  20. d'après une date de début et de fin d'apparition. Des jockers permettent
  21. de les afficher selon une période déterminée.
  22.  
  23.  Deux notes peuvent être liées, leur apparition résultant alors d'une
  24. relation logique entre leur condition d'apparition.
  25.  
  26.  ADELINE ne s'exécute pas s'il n'a pas de notes à afficher. En cas de
  27. changement de jour, il faut relancer Adeline. C'est un choix, je n'ai
  28. pas envie d'avoir un programme qui tourne inutilement dans mon système.
  29.  
  30.  Mais il existe bien d'autres fonctionnalités à découvrir dans Adeline,
  31. je vous invite donc à suivre le reste de la documentation.
  32.  
  33.  
  34.  
  35. 2> Moi :
  36.  
  37.     Thomas PIMMEL
  38.     21 rue du Repos
  39.     68350 BRUNSTATT
  40.  
  41.  Je ne suis pas responsable de tout dommage direct ou indirect
  42. de vos disques ou de vos plantes vertes résultant ou non de
  43. l'utilisation de ce programme. A vos risques et périls mes frères.
  44.  
  45.  
  46.  
  47. 3> Lancement :
  48.  
  49.  Pour lancer ADELINE tapez : "Adeline"
  50.  
  51.  Adeline s'attend à trouver dans le répertoire courant "Adeline.db",
  52. dans le cas contraire elle le créé (avec votre autorisation).
  53.  
  54.  Vous pouvez préciser un autre nom de Base de données pour ADELINE
  55. et bien d'autres choses encore...
  56.  
  57. Syntaxe ReadArgsienne d'adeline (tapez Adeline ?)
  58.  
  59.  DATABASE/K,ADDNEW/K/S,EDIT/K/S,PUBSCREEN=PS/K,FONTNAME=FN/K,
  60.  FONTSIZE=FS/K/N,WINWIDTH=WW/K/N,WINHEIGHT=WH/K/N,QUIET/K/S: 
  61.  
  62.  Tous les arguments sont facultatifs.
  63.  
  64.  MOT CLE            EXEMPLE
  65. ---------------------------------------------------------------------------
  66.  
  67.  DATABASE            DATABASE MaBase.db
  68.  
  69.     Par défaut la base est "Adeline.db".
  70.  
  71.  ADDNEW                ADDNEW
  72.  
  73.     Adeline ajoute une note à la base et sort. Utile si vous avez
  74. le message "La base de données est vide.". Cette note est une note avec
  75. les paramètres par défaut, qui s'affiche toujours.
  76.  
  77.  EDIT                EDIT
  78.  
  79.     Adeline ouvre la fenêtre d'édition. Cette option est indispensable
  80. lorsque qu'aucune note n'est affichée et que vous voulez y avoir accès.
  81.  
  82.  PUBSCREEN            PUBSCREEN ECRAN.PIPO
  83.  
  84.     Adeline cherche à s'ouvrir dans l'écran public "ECRAN.PIPO".
  85.  
  86.  FONTNAME            FONTNAME XEN.font
  87.  
  88.     Par défaut la police utilisée est topaz.font
  89.  
  90.  FONTSIZE            FONTSIZE 9
  91.  
  92.     Par défaut la taille de la police est 8
  93.  
  94.  WINWIDTH            WINWIDTH 160
  95.  
  96.     Largeur de la fenêtre des notes.
  97.  
  98.  WINHEIGHT            WINHEIGHT 69
  99.  
  100.     Hauteur de la fenêtre des notes.
  101.  
  102.  QUIET                QUIET
  103.  
  104.     Pas de message de bienvenue...
  105.  
  106.  
  107.  
  108.  
  109. 4> Les menus
  110.  
  111.     PROJET
  112.  
  113.     A Propos de...        A votre avis?
  114.     Quitter            Plaquer  Adeline
  115.  
  116.     Refaire            Réorganiser la base de donnée.
  117.                 Suppression sur le disque des notes
  118.                 détruites, vérification et suppression
  119.                 éventuelle des notes obsolètes.
  120.                 Remet à jour la numérotation des
  121.                 fenêtres et des relations.
  122.  
  123.     PREFERENCES
  124.  
  125.     Couleur écriture    Couleur du texte
  126.     Couleur fond        Couleur du fond
  127.     Couleur alarme        Couleur que doit prendre une note le jour
  128.                 de l'expiration définitive du délai.
  129.  
  130.     Sauver préférences    Sauver ces couleurs, la position de la
  131.                 fenêtre d'édition et la taille des fenêtres
  132.                 de note (voir aussi Lancement 3>)
  133.  
  134.  
  135.     FENETRE
  136.  
  137.     Editer            Ouverture de la fenêtre d'édition et
  138.                 chargement de toutes les notes en mémoire.
  139.                 Vous pouvez aussi faire un double-click sur
  140.                 une note.
  141.     Nouvelle        Création nouvelle note.
  142.  
  143.     Copier            Copier une note.
  144.     Détruire        Détruire une note (attention, cette note
  145.                 se trouve toujours sur le disque. Pour la
  146.                 supprimer définitivement exécuter
  147.                 "Refaire"
  148.  
  149.     Protégée        Mettre ou enlever le flag "Protégé" (P)
  150.                 qui interdit la destruction d'une note.
  151.     Visible            Mettre ou enlever le flag "Visible" (V)
  152.                 qui force une fenêtre à s'ouvrir.
  153.     Cachée            Mettre ou enlever le flag caché (H)
  154.                 qui force une fenêtre à se fermer.
  155.  
  156.         Ces flags sont visibles dans la barre
  157.         de la fenêtre d'édition. Ces flags ne sont pas
  158.         automatiquement sauvés. Vous devez choisir l'option
  159.         "Valider", "Figer" ou encore "Refaire" pour sauver
  160.         ces flags.
  161.  
  162.     Zoomer            Activer / Désactiver le Zoom (pressez
  163.                 aussi sur le gadget Zoom de la fenêtre)
  164.     Figer
  165.         Fenêtre        Fige la position de la fenêtre et ses flags.
  166.         Tout        Fige toutes les fenêtres.
  167.     Réorganiser        Replacer les fenêtres sur l'écran.
  168.  
  169.  
  170.  
  171.  
  172. 5> Les gadgets
  173.  
  174.  Dans la fenêtre d'édition se trouvent des gadgets. Ces gadgets
  175. servent à modifier les caractéristiques des notes.
  176.  
  177.  Les trois premiers gadgets servent à définir quelles notes vous voulez
  178. modifier. Vous entrez le numéro de la note (raccourci N) ou vous
  179. utilisez les gadgets < et >.
  180.  
  181.  <        Editer note précédente
  182.  
  183.  >        Editer note suivante
  184.  
  185.  Titre        Titre de la fenêtre
  186.  
  187.  Défaire    Retourner aux dernières valeurs sauvées
  188.  
  189.  Texte        Texte de la fenêtre (208 caract. max)
  190.  
  191.  Tous les    Jour de la semaine d'apparition ou "Tous les jours"
  192.  
  193.  Date        Affichage de la date du jour
  194.  
  195.  De la date    Date de début d'affichage
  196.  
  197.  à la date     Date de fin d'affichage (voir section Spécificités
  198.         étendues 6>)
  199.  
  200.  Relation    Relation avec une autre note (lien logique, voir section
  201.          spécificités étendues)
  202.  
  203.  Avec        Numéro de la note avec laquelle vous voulez avoir une
  204.          relation.
  205.  
  206.  Valider    Sauver vos modifications (NE L'OUBLIEZ PAS AVANT DE
  207.          CHANGER DE NOTE)
  208.  
  209. Gadget de fermeture de la fenêtre d'édition ou touche <ESC> : terminer
  210. l'édition, recalcul des relations et des apparitions.
  211.  
  212.  
  213.  
  214. 6> Spécificités étendues
  215.  
  216. Les dates :
  217.  
  218.  Vous pouvez mettre n'importe quelle date valide dans les gadgets
  219. "De la date" et "à la date". Vous pouvez remplacer le jour, le mois
  220. ou l'année entière par des *. Vous pouvez taper A<nb de jours>
  221. dans le gadget pour que Adeline mette automatiquement la date du
  222. jour dans ce gadget + <nb de jours> (exemple A10 affichera la date
  223. d'aujourd'hui + 10 jours).
  224.  
  225.  Attention : l'algorithme est assez puissant, si vous rentrez
  226.  
  227.     20/*/*        10/*/*
  228.  
  229.  la note s'affichera du 20 d'un mois au 10 du mois suivant
  230.  
  231.  Exemple : nous sommes le 26.2.1994
  232.  
  233.     20/*/*        10/*/*        du 20/2/1994 au 10/3/1994
  234.                     période mensuelle
  235.  
  236.     10/10/*        10/3/*        du 10/10/1993 au 10/3/1994
  237.                     période annuelle
  238.  
  239.     10/*/*        10/*/*        tous les 10 du mois
  240.                     période mensuelle
  241.  
  242.     */*/1995    */*/*        à partir du 1/1/1995 et
  243.                     au 31/12/65535 (!)
  244.  
  245.  Ces conditions d'apparition sont cumulables avec la spécification
  246. d'un jour de semaine.
  247.  
  248.  Ex:    Tous les  | Samedi |
  249.  
  250.     De la date  1/*/*   à la date  7/*/*
  251.  
  252.  Affiche la note le premier samedi de chaque mois (pour le contenu
  253. de la note demandez à Zarbi).
  254.  
  255. Les relations :
  256.  
  257.     Aucune, aucune relation
  258.  
  259.     Toujours, l'affichage de cette note entraîne automatiquement
  260.           l'affichage de l'autre.
  261.     AND,      s'affiche seulement si l'autre est affichée.
  262.     XOR,      s'affiche uniquement si l'autre n'est pas affichée.
  263.  
  264.  La routine est récursive, je ne garantis pas l'effet en cas de relations
  265. contradictoires (pas de plantages système en tous cas, pour le reste c'est
  266. à vous de savoir ce que vous vouliez obtenir).
  267.  
  268. Limitation :
  269.  
  270.  Adeline est plus à l'aise sur un disque dur, en effet Adeline
  271. ne garde en mémoire que les notes réellement affichées et les
  272. recharge lors d'une édition.
  273.  
  274.  Adeline ne peut ouvrir plus de 14 fenêtres de notes sur l'écran
  275. simultanément. Cela est dut à une limitation d'Exec qui ne permet
  276. pas à une tâche d'avoir plus de 16 ports de message.
  277.  
  278.  Si c'est une limite grave pour vous, payez-vous un(e) vrai(e) secrétaire,
  279. vous en avez besoin...
  280.  
  281.  
  282.  
  283. 7> Spécifications techniques :
  284.  
  285.  ADELINE est écrit en assembleur, compatible 2.0 et 3.0.
  286.  La taille du binaire est 11316 octets.
  287.  
  288.  Une note d'ADELINE prend 248 octets exactement et tout compris. Le
  289. programme ne charge en mémoire que les notes réellement affichées à
  290. l'écran.
  291.  
  292.  ADELINE réclame la présence des libraries suivantes :
  293.  
  294.     Library            Version        Commentaire
  295.  
  296.     reqtools.library    V38        (c) Nico François
  297.     intuition.library    V37
  298.     dos.library        V37
  299.     graphics.library
  300.     gadtools.library    V37
  301.     keymap.library        V37
  302.     diskfont.library
  303.  
  304.  
  305. 8> Allergie
  306.  
  307.  Je viens de lire la doc d'un programme MINABLE distribué avec un
  308. journal (honorable ce n'est pas lui qui est en cause) français.
  309. L'auteur se croit drôle en proposant le source ( C ) de son programme
  310. contre... 40FF!!!!!!!
  311.  
  312.  C'est bien sûr scandaleux, on ne fait pas payer un débutant qui va
  313. se servir de votre source pour approfondir ses connaissances sur
  314. l'Amiga! A la limite on fait payer l'utilisation du programme.
  315.  
  316.  J'en profite pour signaler que si les autres (l'Alien branque et le
  317. Boubou) m'avaient laissé plus de place j'aurais bien mis toutes mes
  318. sources à la disposition de la communauté Amiga (seules les sources
  319. de Sound! sont disponibles sur cette disquette). Si vous voulez
  320. mes sources (sauf EcoDisk) écrivez-moi en envoyant une disquette,
  321. (si possible pas vièrge, mettez-y un module, une image ou un délire)
  322. les timbres pour la réponse, et précisez quelle source vous voulez,
  323. et sourtout pas d'argent pour ça!!! Je précise que mes sources
  324. sont en assembleur (pour le C négociez avec Brice).
  325.  
  326.  Ces précisions n'engagent que moi et non les autres auteurs de
  327. cette disquette.
  328.  
  329. 9> Remerciements
  330.  
  331.     Brice Allenbrand (pour tests Enforcer et support moral)
  332.     La fonction _LVOReadArgs(a6)
  333.     Le café et mon neveu Antoine pour m'avoir réveillé tous
  334.     les matins TRES tôt.
  335.     Serge Gainsbourg pour la musique.
  336.     France-Inter pour les actualités.
  337.     Kronenbourg pour le support moral.
  338.     Les mauricettes du Klapp pour le support tout court.
  339.     Mon cerveau pour marcher à peu près normalement.
  340.     Le sommeil pour m'empêcher de programmer trop.
  341.     L'inventeur du débuger pour :
  342.  
  343.         move.l    Font(a4),a0
  344.         jsr    CloseFont(a6)
  345.         (guru)
  346.  
  347.     SpriteClock pour afficher 3:29
  348.     Mon lit...
  349.     Jean-Marc Boursot pour son aide dans le débugage de la
  350.     GadTools 2.0 (grr!!!!!!)
  351.  
  352.  
  353.                 Thomas PIMMEL.x
  354.                 Float à BRUNSTATT.
  355.